Skip to content

Extension descriptions and dimensions#2048

Merged
4ian merged 1 commit intomainfrom
cursor/extension-descriptions-and-dimensions-e483
Feb 21, 2026
Merged

Extension descriptions and dimensions#2048
4ian merged 1 commit intomainfrom
cursor/extension-descriptions-and-dimensions-e483

Conversation

@4ian
Copy link
Collaborator

@4ian 4ian commented Feb 21, 2026

Add concise, AI-optimized short descriptions and 2D/3D dimension tags to all reviewed extensions for improved AI agent understanding and selection.


Open in Web Open in Cursor 

… extensions

- Updated shortDescription for all extensions (max 15 words) to be
  information-dense and suitable for AI/LLM agent consumption
- Added 'dimension' field ('2D', '3D') to 75 extensions where applicable
  (65 2D, 10 3D), placed between shortDescription and version
- Descriptions pack key features, limitations, and use cases concisely
- No changes to long descriptions (none had critical missing info)

Co-authored-by: Florian Rival <4ian@users.noreply.github.com>
@cursor
Copy link

cursor bot commented Feb 21, 2026

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
Learn more about Cursor Agents

@4ian 4ian requested a review from a team as a code owner February 21, 2026 14:02
@4ian 4ian merged commit 93773d3 into main Feb 21, 2026
5 checks passed
@4ian 4ian deleted the cursor/extension-descriptions-and-dimensions-e483 branch February 21, 2026 14:13
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/hexagon-multiple-outline.svg",
"shortDescription": "Snap objects to an hexagonal grid.",
"shortDescription": "Snap objects to hexagonal grid positions with configurable cell size.",
"dimension": "2D",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Of course, it's configurable. The original description was better.

"name": "AutoTyping",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/typewriter.svg",
"shortDescription": "Reveal a text one letter after the other.",
"shortDescription": "Typewriter text reveal effect, one letter at a time. For Text/BitmapText objects.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The punctuation is a bit out of place. I think, it's not necessary to list compatible object types.

"name": "BehaviorRemapper",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/alpha-w-box-outline.svg",
"shortDescription": "Quickly remap keyboard controls.",
"shortDescription": "Remap keyboard controls for platformer and top-down movements. WASD/arrows presets.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"WASD/arrows presets" is unnecessary.

"name": "BoidsMovement",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/Glyphster Pack/Master/SVG/Restaurant/Restaurant_restaurant_seafood_animal_fish.svg",
"shortDescription": "Simulates flocks movement.",
"shortDescription": "Flock/swarm movement: separation, alignment, cohesion with attraction and obstacle avoidance.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"separation, alignment, cohesion" is probably too technical for the short description

"name": "Bounce",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/volleyball.svg",
"shortDescription": "Bounce the object off another object it just touched.",
"shortDescription": "Bounce objects off collisions using forces. Not for Physics engine or Platformer.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Punctuation is out of place. I'm not sure if "Not for Physics engine or Platformer" is necessary because "using force" should be enough for a short description.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would avoid using this extension at all actually I'm not sure it should be "reviewed" anymore.

"name": "Noise",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/sprinkler.svg",
"shortDescription": "Generate noise values for procedural generation.",
"shortDescription": "Generate 1D-4D Simplex noise for procedural terrain, textures, and positioning.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The original description was better.
We can really generate "textures" with it.
We don't care about technical stuffs like "1D-4D Simplex".

"name": "ObjectPickingTools",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/selection-ellipse-arrow-inside.svg",
"shortDescription": "Adds various object picking related tools.",
"shortDescription": "Object picking: select nearest, random, by index, filter, and unpick instances.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • nearest? No!
  • random? No!
  • index? No!
  • filter? Talk about being specific...

This must be reverted.

"name": "ObjectSpawner",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/plus-one.svg",
"shortDescription": "Spawn (create) objects periodically.",
"shortDescription": "Spawn objects periodically with configurable interval, capacity, and spawn area.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Of course, it's configurable. The original description was better.

"name": "ObjectStack",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/Line Hero Pack/Master/SVG/Videogames/Videogames_cards_game_solitaire_poker_blackjack_casino.svg",
"shortDescription": "An ordered list of objects and a shuffle action.",
"shortDescription": "Ordered object stack/queue: add, remove, access, sort, and shuffle. For card games.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not for card games specifically.
There is no "sort" features.

This must be reverted.

"name": "OrbitingObjects",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/Glyphster Pack/Master/SVG/Space/Space_earth_moon_orbit.svg",
"shortDescription": "Make objects orbit around a center object in a circular or elliptical shape.",
"shortDescription": "Objects orbit in circular or elliptical paths around a center object.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can keep "path" instead of "shape" but otherwise the original description is better.

"name": "PanelSpriteButton",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/Line Hero Pack/Master/SVG/Interface Elements/Interface Elements_interface_ui_button_ok_cta_clock_tap.svg",
"shortDescription": "A button with a label.",
"shortDescription": "Resizable 9-patch button with label. Handles click, hover, keyboard, and gamepad.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We don't need a technical definition of a button.

"name": "PanelSpriteContinuousBar",
"previewIconUrl": "https://asset-resources.gdevelop.io/public-resources/Icons/Glyphster Pack/Master/SVG/Interface Elements/ea06363a57846caab544f536b78a952234b68d4941d41c1577852a1d61aefec3_Interface Elements_interface_ui_loading_progress_bar.svg",
"shortDescription": "A bar that represents a resource in the game (health, mana, ammo, etc).",
"shortDescription": "Continuous resource bar (9-patch) for health/mana/ammo with smooth fill animation.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The original description was better.

"name": "PanelSpriteSlider",
"previewIconUrl": "https://asset-resources.gdevelop.io/public-resources/Icons/Line Hero Pack/Master/SVG/UI Essentials/1678c39a3b2bd3df4f82a8a293770db4986a6bcfd3f78e738ddfc86e39176423_UI Essentials_sliders_options.svg",
"shortDescription": "A draggable slider that users can move to select a numerical value.",
"shortDescription": "9-patch slider for numerical values. Supports mouse, touch, keyboard, and gamepad.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Supports mouse, touch, keyboard, and gamepad." You wish!

This must be reverted.

"name": "Parallax",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/image-move.svg",
"shortDescription": "Behaviors to animate Tiled Sprite objects in the background, following the camera with a parallax effect.",
"shortDescription": "Parallax scrolling for Tiled Sprite backgrounds with configurable speed ratios.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"with configurable speed ratios." can be removed.

"name": "ParticleEmitter3D",
"previewIconUrl": "https://asset-resources.gdevelop.io/public-resources/Icons/f2e5a34bf465f781866677762d385d6c8e9e8d203383f2df9a3b7e0fad6a2cb5_fire.svg",
"shortDescription": "Display a large number of particles in 3D to create visual effects in a 3D game.",
"shortDescription": "3D particle emitter: configurable lifetime, color, size, gravity, and emission shapes.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Of course, it's configurable.
No need to repeat the extension name.
The original description was better.

"name": "PlatformerCharacterAnimator",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/Glyphster Pack/Master/SVG/Sports and Fitness/Sports and Fitness_training_running_run.svg",
"shortDescription": "Change animations and horizontal flipping of a platformer character automatically.",
"shortDescription": "Auto-animate platformer characters: idle, run, jump, fall with horizontal flip.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No need to list all platformer states.
The original description was better.

"name": "PopUp",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/message-alert.svg",
"shortDescription": "Display pop-ups to alert, ask confirmation, and let user type a response in text box.",
"shortDescription": "System popup dialogs: alert messages, confirmation prompts, and text input boxes.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No need to prefix it with the extension name, we got it.
Starting with a verb is better.

"name": "ReadPixels",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/Glyphster Pack/Master/SVG/Computers and Hardware/Computers and Hardware_screen_computer_image.svg",
"shortDescription": "Read the values of pixels on the screen.",
"shortDescription": "Read RGB color values of pixels at specific screen coordinates.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually it doesn't give the RGB value but channel values.

"name": "Record",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/video-vintage.svg",
"shortDescription": "Actions to record the game and players download the clips. Works on desktop, and in the browser.",
"shortDescription": "Record gameplay as video clips for download. Pause/resume. Desktop and browser.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Pause/resume. Desktop and browser." can be removed.

"name": "RectangleMovement",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/shape-rectangle-plus.svg",
"shortDescription": "Move objects in a rectangular pattern.",
"shortDescription": "Move objects in a rectangular path with configurable width, height, and speed.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Of course, it's configurable. The original description was better.

"name": "RectangularFloodFill",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/Glyphster Pack/Master/SVG/Graphic Design/Graphic Design_grid.svg",
"shortDescription": "Create objects as a grid to cover a rectangular area or an other object.",
"shortDescription": "Fill rectangular areas with grid-arranged object instances. Configurable spacing.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Fill" is misleading, it could be understood as "stretch over".
Of course, it's configurable.
The original description was better.

"name": "RegEx",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/regex.svg",
"shortDescription": "Functions for using regular expressions to manipulate strings.",
"shortDescription": "Regular expression operations: test, match, replace, and extract from strings.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"shortDescription": "Regular expression operations: test, match, replace, and extract from strings.",
"shortDescription": "Manipulates string with regular expressions.",

"name": "RollingCounter",
"previewIconUrl": "https://asset-resources.gdevelop.io/public-resources/Icons/e509cccd7fb426978c4a79b639670f624f773a886848d288a12be5c28dd7d380_sort-numeric-variant.svg",
"shortDescription": "Smoothly change a counter value in a text object.",
"shortDescription": "Smoothly animate number changes in text objects with rolling counter effect.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is no "rolling counter effect".

This must be revert.

"name": "RTSUnitSelection",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/pencil-box-outline.svg",
"shortDescription": "Allow player to select units by clicking on them or dragging a selection box.",
"shortDescription": "Select units by click or drag-box. Control groups (Ctrl+number). For RTS games.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Control groups" is oddly specific.
It's not necessarily for RTS.

Suggested change
"shortDescription": "Select units by click or drag-box. Control groups (Ctrl+number). For RTS games.",
"shortDescription": "Select units by clicking on them or dragging a selection box.",

"name": "ScoreCounter",
"previewIconUrl": "https://asset-resources.gdevelop.io/public-resources/Icons/48ec8784eacd92181e4a3bde4755962b5f6edf986e624fc85ea423a31408450d_counter.svg",
"shortDescription": "An animated score counter with an icon and a customisable font.",
"shortDescription": "Animated score counter UI object with customizable icon, font, and animation.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"shortDescription": "Animated score counter UI object with customizable icon, font, and animation.",
"shortDescription": "Animated score counter with an icon.",

"name": "SpeedRestrictions",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/speedometer.svg",
"shortDescription": "Limit the maximum movement and rotation speed of an object from forces or the 2D Physics behavior.",
"shortDescription": "Limit max movement and rotation speed for forces-based or Physics 2D objects.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"shortDescription": "Limit max movement and rotation speed for forces-based or Physics 2D objects.",
"shortDescription": "Limit max movement and rotation speed for forces-based or Physics 2D.",

"name": "SpriteMasking",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/transition-masked.svg",
"shortDescription": "Use a sprite or a shape painter to mask another object.",
"shortDescription": "Mask objects using a sprite or Shape Painter. Only masked area is visible.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"shortDescription": "Mask objects using a sprite or Shape Painter. Only masked area is visible.",
"shortDescription": "Mask objects using a sprite or a shape painter.",

"name": "SpriteMultitouchJoystick",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/Line Hero Pack/Master/SVG/Videogames/Videogames_controller_joystick_arrows_direction.svg",
"shortDescription": "Joysticks or buttons for touchscreens.",
"shortDescription": "On-screen multitouch joystick/button objects. Mappers for platformer, top-down, 3D, FPS.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"shortDescription": "On-screen multitouch joystick/button objects. Mappers for platformer, top-down, 3D, FPS.",
"shortDescription": "On-screen multitouch joystick and buttons.",

"name": "SpriteSheet",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/google-spreadsheet.svg",
"shortDescription": "Animate a tiled sprite from a sprite sheet.",
"shortDescription": "Animate Tiled Sprite from sprite sheet image (horizontal, vertical, or JSON layout).",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Of course, it's configurable. The original description was better.

"name": "SpriteToggleSwitch",
"previewIconUrl": "https://asset-resources.gdevelop.io/public-resources/Icons/Line Hero Pack/Master/SVG/Interface Elements/8d0cd8cd0c9318f4f6efde6ee6b4c192bd19306467f80c9970387a259300f895_Interface Elements_interface_ui_toggle_switch_on_off.svg",
"shortDescription": "Toggle switch that users can click or touch.",
"shortDescription": "Sprite-based toggle switch. Click/touch to toggle with customizable on/off sprites.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The original description was better.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants